#6B2EF919
Original Help text by Everett Kaser
@C>
HELP.TXT
Copyright 2017 Everett Kaser Software
All rights reserved

NOTE: While this file is available for you to modify for your own
use, NO modified versions of it may be redistributed without the
consent of Everett Kaser Software.  If you translate this file to
another language, please email a copy to everett@kaser.com for
possible inclusion in a future revision of the game or release on
the game web page.  The above copyright notice MUST be retained 
in all modified versions.
@C>

@C>This is a comment block.
It can have any format or any content, just so long as none of its
lines START with an '@'.  A comment block starts with a line that
begins with "@c>" (or "@C>") and ends with another line that starts
with the same sequence.  There can be any number of empty lines AFTER
the end of a comment block, but NO other characters.  The next thing
encountered besides empty lines MUST be either the end of file or a
line starting with "@c>" or "@p".  NOTE: "empty lines" means
JUST that: no characters at all, including no spaces or tabs, just
CR/LF pairs or simple LF characters.

If you modify this file, you should TEST all of your changes by 
running the program and carefully reading the changed pages to verify
that what you've done is correct and displays correctly.  It's amazing
how often you catch things when reading the text in the actual HELP
dialog versus reading it in your text editor! :-)

Each "page" of help is enclosed within a matching pair of "@p" delimiters.
The first (starting) "@p" has this format:
	@p n "Title" "sub-title">
where 'n' is a number of your choosing.  This number is the page ID,
which is used as an identifier for links.  The first page in the file 
MUST have an ID of 0, which is always the "copyright" help page.  Much 
of the contents of this page are hard-coded in the game and cannot be 
edited.  What CAN be edited is included below.  Note that page 0 has 
no title or subtitle strings (they're hard-coded in the program).  This
page MUST be followed by page ID 1, which is the CONTENTS page.  All
other following pages may have any ID values in any order, they need
not be sequential (but they MUST be unique).  The pages will be presented
in the order they appear in this file, regardless of their ID values.
Again, the ID is ONLY used for link purposes.  If you need to use a
quote character within a title or sub-title, precede it with a '\'
character.  If you need to include a '\' character, use two of them
together (\\).

NOTE: There is currently a hard limit of 128 pages of help.  This should
be more than sufficient, since each page is a different subject, and 
there CAN'T be that many subjects in any one game!  Can there? :-)

The @ markers that may be used in this file are:
	@C> starts a comment block, must be terminated by @C>
	@P pid "title" "sub-title"> starts a page, specifying the page ID 
		(pid) of the page, and the text for the title and sub-title.  
		A page must end with a line containing @P>
	@L anywhere within the text of a page causes a line-break (text is
		normally auto-wrapped).  Two or three @L's may be used together
		to cause white-space between paragraphs.  This marker is stand-
		alone, and has no "terminating" marker.
	@T n> causes following text to be moved to the offset of n*LU from
		the left margin (LU=1 Logical Unit, and the help text window
		is 144 LUs wide).
	@G must always occur at the start of a line (ie, all graphics must
		be left-justified, against the left margin).  Multiple @G's can 
		be "concatenated" together at the start of a line to build up a 
		graphic out of several smaller pieces, but there can be no text 
		before or between them on the line.  @G specifies a graphic image 
		to be displayed.  The format of the command, in full, is one of these:
			@GG i>		draws the i-th game image in the size that
						matches the current logical units setting.
						This is GAME-SPECIFIC!
			@GU i>		draws button from the UI graphics file that
						starts at the i-th location (12 buttons per row,
						numbered 0-11 on the first row, 12-23 on the
						second row, 24-35 on the third row).  Draws a
						single-wide button.
			@GU d i>	the 'd' is a literal letter 'd' (or 'D').  This
						is the same as "@GU i>", except it's a double-wide
						button.
			@GH sx sy sw sh	dw
						draws the specified region from the HELP graphic
						file. sx,sy,sw,sh are specified in HELP graphic
						logical units (which may be a different size than
						the current game logical units).  The image gets
						scaled to current game logical units, and dw specifies
						the target (destination) width.  (The destination
						height is then dh = dw*sh/sw.)
			@G>			terminates any "wrapping" of text or graphics around
						the current graphic image, moving the current X output
						location to the left side and the current Y output
						location to the bottom of any current graphic image.

		Images must ALWAYS be against the left edge of the help window, 
		(unless several images are together, but still the first one
		must be against the left edge, that's just the way it is...)
		and all following text is "wrapped around" the picture
		until past the picture, at which point the text returns to the
		normal left margin.
	@B causes all following text to be BOLD, or if text is currently BOLD,
		causes text to stop being BOLD.  ie, bracket bold text with a
		pair of @B's.
	@I is used just like @B, but to make text ITALIC.
	@U is used just like @B and @I, but to make text UNDERLINED.
	@N turns off (NORMAL) all text @B, @I, @U attributes.
	@2 causes following text to be RED (or whatever "help highlight" color
		is specified in the UI graphics file).
	@1 causes following text to be BLACK (or whatever "help text" color
		is specified in the UI graphics file).
	@M n> specifies a TARGET # on the current help page for a link from
		another page.  'n' may be any value from 0 to 31 (there's a max
		of 32 link targets on any one page).
	@H pid mid "link text">
		Specifies a Hypertext Link with "link text" as the link text.
		(Imagine that.)  The pid is the page ID (see @P), and the mid
		is the mark ID (see @M) for the target jump.  For jumping to
		the START of a page, mid can be 0 and no @M need be specified
		on the target page.  There can be a max of 128 hyperlinks on
		any one help page.
	@S0 gets replaced by the name of the folder in which the game is installed.
	@S1 gets replaced by the name of the game.
	@S2 gets replaced by the xxLOG.CSV file name
	@S3 gets replaced by the xx.CFG file name
	@S4 gets replaced by the PROGRAM installation path
	@S5 gets replaced by the DATA (created files) path
	@S6 gets replaced by the OS Version information
	@S7 gets replaced by the name of the Ctrl key ("Ctrl" on PC's, "Cmd" on Macs)
@C>
@C>***********************************************************************
@C>
@P 0 "" "">
Contact information for orders and support:@L
@L
@T7>mail:@T15>EVERETT KASER SOFTWARE@L
@T15>POB 403@L
@T15>ALBANY OR 97321-0117@L
@T5>phone: 1-541-928-5259@L
@T5>e-mail: everett@@kaser.com@L
@T2>web site: www.kaser.com@L
@L
This game is distributed in shareware (demo) and licensed versions.  The
shareware version may be freely distributed (but not sold).  The licensed
version may not be redistributed.  It may be purchased for US $19.95 as
a download from www.kaser.com, or for $24.95 on a CD.  What a deal!@L
@L
You can print an order form by closing this dialog, clicking on the Help
menu, and then clicking on "Print order form" (Imagine that!)@L
@L
@1Click on the @INext page@I button or on this @H 1 0 "Help Contents"> link to
see links to the available help pages.@L
@L
This software is based in part on the work of the Independent JPEG Group
(ie, it includes a modified version of some of their software for decoding .JPG images.)
@P>
@C>***********************************************************************
@C>
@P 1 "Help Contents" "(REAL men don't ask for directions...)">
You can navigate through the help by:@L
@T5>@2clicking on a link (underlined green text)@L
@T5>clicking on the @INext page@I and @IPrev page@I buttons@L
@T5>using the @IRight cursor@I and @ILeft cursor@I keys@L
@1Within a help page, if the entire page doesn't fit in this window,
a scroll bar will appear at the right, and you can move up and down
on that page by manipulating the scrollbar, by using the @IUp cursor,
Down cursor, Page Up,@I and @IPage Down@I keys, or by placing the mouse
cursor on this window and rolling the mouse wheel (if your mouse has a wheel).@L
@L
@2LEFT-click and HOLD the @IHide@I button below to temporarily hide this dialog.@1@L
@L
The @IContents@I button always brings you back to this page, and the
@IBack@I button takes you back to previous pages you've visited.@L
@T5>@H 2 0 "Basic Information (what to do and how to play)">@L
@T5>@H 3 0 "Clues, Hints and Tips (how to solve these puzzles)">@L
@T5>@H 5 0 "Options (changing the game's behavior)">@L
@T5>@H 6 0 "Keys, Toolbar, and Menu (controlling the game)">@L
@T5>@H 7 0 "Mouse Button Mapping (mousing around)">@L
@T5>@H 8 0 "Graphics (changing the game's appearance)">@L
@T5>@H 9 0 "Music & Sounds (changing the game's sound)">@L
@T5>@H 10 0 "All about books (Is there a librarian in the house?)">@L
@T5>@H 11 0 "Fonts (I want it MY way!)">@L
@T5>@H 12 0 "Running the game on non-Microsoft operating systems">@L
@T5>@H 0 0 "Ordering information (send money!)">@L
@T5>@H 13 0 "Technical Info (where're my files???)">@L
@T5>@H 14 0 "Credits (who's to blame???)">@L
@P>
@C>***********************************************************************
@C>
@P 2 "Basic Information" "(Boot Camp for the bewildered...)">
Beckett Gage has one of the most impressive libraries on the block (it's a very
large block). The problem is that the Cabbage Monster has gotten into the library
and shredded all of the books. Can you help him re-assemble his library? Every
page is important!@L
@L
WARNING: Most of the books included in this game are over 100 years old and,
as such, contain some depictions of race, sex, violence and drug use that are
no longer considered acceptable in modern culture. Reading is always a dangerous
activity which can test your levels of tolerance, knowledge and understanding.
This material should be read with the historical context firmly in mind, and
don't allow a few objectionable paragraphs to cause you to throw out the baby
with the bath water.@L
@L
@GH 0 0 140 49 80>@G>@L
The above shows one VERY simple puzzle. The game is essentially a jigsaw puzzle
(minus the jigs), but primarily of text (sometimes with a 'cover' illustration
and maybe occasional interior illustrations). Each puzzle consists of two side-by-side
'pages'. But you shouldn't think that you're solving individual puzzles.  In essence,
you're solving the BOOK, one puzzle at a time. But this is not just a puzzle solving
game, it's also a book reading experience.  As you solve the pages, you'll be reading
the book. The game keeps track of your @Ibookmark@I,
how far you've solved "into the book," and if you change puzzle sizes (number of tiles
or number of lines of text per tile), the game will position you at the puzzle number
for that puzzle size which contains your current bookmark. You can not "peek ahead"
at puzzles beyond where your bookmark is located, you can only see the puzzles you've
solved and the current unsolved puzzle.@L
@L
NOTE: For each puzzle size, the book is broken up into puzzles that 'fit' that puzzle
size, starting at the beginning of the book and processing forward. This means that your
bookmark from one puzzle size, which was at the beginning of a puzzle at that size, will
fall in the MIDDLE OF A PUZZLE at most other puzzle sizes. So, if you solve a puzzle at
one puzzle size, then switch to another puzzle size, you'll find that the text at the beginning
of that puzzle is text that you've already put together and read. But the text at the
END of that puzzle will be new text that you've not yet seen, because your @Icurrent bookmark@I
falls somewhere in the middle of that puzzle. Once you solve that puzzle at that new
puzzle size, then all succeeding puzzles will contain all new text.@L
@L
@GH 238 50 20 40 10>There are four different settings for the number of tiles in the puzzle
(the blue 1-4 buttons) and four different settings for the number of lines of text on each
tile. Size 1-1 is 6 tiles high and 8 tiles wide with only one line of text per tile,
resulting in an easy puzzle with very large text.  Size 4-4 is 15 tiles high and 20 tiles
wide with four lines of text per tile, resulting in an almost unplayable puzzle (unless
you have a very large screen and very sharp eyes). You will find that different puzzle SIZES
(combinations of tile and lines-per-tile settings) provide very different playing
experiences (the combination of solving the puzzles and reading the story). Sometimes
you'll want a tough challenge, sometimes you'll just want to get the next puzzle solved
so you can read more of the story.  Please experiment with the puzzle size settings to
find the ones that are most enjoyable for you.@L
@L
NOTE: It is possible to create a book for Beckett's Books which has no actual text, but
instead is comprised entirely of images (even if the images contain words, they remain
images). In that case, the lines-per-tile setting will have NO effect.@L
@L
NOTE: Just because there are bigger, more complex puzzles does NOT mean you have to play
them. Sometimes you may want a 'quick' game, sometimes you may be willing to commit an hour or
more to a single puzzle.  Choose your size wisely!@L
@L
Different books are of different lengths, and they each break up into different numbers
of puzzles at different puzzle sizes.  When you've solved an entire book, you can load a
different book, or you can use the @IRestart book@I button to completely unsolve the book
and start it over.@L
@L
You can drag tiles around with the LEFT mouse button. If the @IAuto-glue tiles@I options are
enabled, then when two pieces are next to each other that BELONG next to each other, they
will be "glued" together (and their coloring will change from red to green). If the @IAuto-lock tiles from corners@I
option is enabled, when the corner pieces are put in their proper place, they will automatically
be locked in place and will turn white. When other pieces get glued to those locked pieces,
they become locked as well.@L
@L
There are two 'windows': the puzzle (where you solve the puzzle) on the left and the work area
on the right. The game display itself can be in one of two modes.  If the @IShow ENTIRE work area@I
option is OFF, then the tiles are sized such that the puzzle area takes up the entire HEIGHT of
the game window (minus the Explanation Box at the top), and a horizontal scrollbar appears if
the window is not wide enough to show the full puzzle. The work area on the right will usually
have one or both scrollbars.  Note that the work area tiles are spaced a little bit apart from
each other (the amount of this spacing can be controlled in the @IPlayer-Options@I dialog), plus
the work area has vertical space for about 1/3 more tiles than there are tiles in the puzzle.
When in this mode, the vertical bar dividing the puzzle area from the work area can be dragged
left or right to adjust their relative sizes.@L
@L
If the @IShow ENTIRE work area@I option is ON, then the tiles are sized so that the entire
work area AND the entire puzzle can both be completely displayed with no scroll bars. In
this mode, you can SEE all of the tiles at once, but you may not be able to READ the letters
on the tiles, depending upon the puzzle size you're playing, the size of your display, and
the sharpness of your eyes. In this mode, the vertical dividing bar between the windows can
NOT be dragged.@L
@L
NOTE: besides changing the @IShow ENTIRE work area@I option in the @IPlayer-Options@I dialog,
you can also toggle it by MIDDLE-clicking in the puzzle or work area windows, and also by
pressing the Z key (think Zoom).@L
@L
Depending upon the @IPlayer-Options@I settings, all pieces may start in
the work area, or all pieces may start in the puzzle area, or some mixture thereof. When you
RIGHT-click on a tile, that tile is moved to the other window. If you @S7-RIGHT-click on
a window, ALL tiles from that window are sent to the other window.@L
@L
There are MANY options available which allow you to configure the game to work
more closely to your own tastes.  You'll find these under the @IPlayer@I menu,
particularly in the @IOptions@I dialog.  You
can read more about these on the @H 5 0 "Options"> help page.@L
@L
NOTE: Tiles which have NO text (not even a single pixel) and no image drawn on them are 'empty'
and are marked with a blue square in the middle of them.  These tiles are interchangeable.
However, empty tiles are NEVER glued to other tiles until the other tiles are LOCKED.@L
@L
NOTE: The game does not know how many puzzles there are in a book until it has formatted the
book from start to finish (at any given puzzle type/size). It does this automatically in the
background while you're playing.  Meanwhile, the number of puzzles in the book at the current
puzzle type is shown in the "explanation box" at the top of the game window in []s. If the
total number of puzzles isn't known, then the number that have been formatted so far is show
with a '+' after it (e.g., "[26+]").  As long as the '+' is showing, you know there is MORE
than that many puzzles.  When the '+' eventually goes away, then the number displayed is the
"final answer" to how many puzzles are in the current book at the current puzzle type/size.@L
@L
@L
@U@BUSING THE MOUSE TO PLAY THE GAME@B@U@L
@L
NOTE: The functions that are mapped to the mouse buttons can be
changed by using the @IPlayer-Mouse button mapping@I dialog.  These are
the default settings...@L
@L
In the puzzle:@L
@BLEFT-drag@B to move tiles.@L
@BRIGHT-click@B to send a tile to the other window.@L
@B@S7-RIGHT-click@B to send ALL tiles in the window to the other window.@L
@BMIDDLE-click@B or @B@S7-LEFT-click@B to toggle the @IShow ENTIRE work area@I option.@L
@L
If you don't have a MIDDLE mouse button, please notice that you can achieve its function by holding
down the @B@S7@B key and using the LEFT button.@L
@L
If your mouse has a mouse wheel, you can scroll a window if it has scroll bars. If a window only
has one scrollbar, the wheel will scroll in the corresponding direction by rolling the wheel
forward or backward. If a window has both scroll bars, the wheel will roll up/down by default,
or left/right by holding down the @S7 key. The
direction of the scrolling can be reversed in the @IPlayer-Mouse button mapping@I dialog
with the @IReverse mouse wheel movement@I option (naturally).@L
@L
All of these button mappings can be changed once you become familiar with the game.  If you
bring up the @IPlayer-Mouse button mapping@I dialog, you will see that
there are a lot of ways you can map actions onto the mouse buttons.
For more information on how to use this dialog and how the various functions
affect the game play, see @H 7 0 "Mouse Button Mapping">.@L
@L
If you're playing on a TOUCH-SCREEN device, there's a @IShow touch-screen mouse buttons@I
checkbox in the @IPlayer-Mouse button mapping@I dialog which will enable five buttons on
the toolbar.  These buttons let you quickly select which "virtual mouse button" you're
clicking or holding when you touch the screen with your finger.
See @H 7 0 "Mouse Button Mapping"> for more information on this subject.@L
@L
@P>
@C>***********************************************************************
@C>
@P 3 "Clues, Hints and Tips" "(HELP!  I'm all messed up!!!)">
@UStandard Disclaimer@U: I've been advised to state this right up front: I am @Bnot@B responsible for
what happens as a result of your playing this game.  If you lose your mind, your job, your house,
your spouse, or your mouse as a result of playing "just one more game," it's @Inot@I my fault.
@BYOU@B are in control of your hands and fingers and feet.  Go outside, get some exercise, play
with your kids (or cat or dog or...).  Remember: you have a @I@ULIFE@U@I.  You've been warned.@L
@L
When first playing this game, I recommend leaving the "border width" at a non-zero
value to make it easier to spot the edge pieces. I also recommend leaving @IAuto-lock tiles@I and
@IAuto-glue tiles@I options
enabled. Once you get better at playing the game, then you can turn those off if you're
hankering for a bigger challenge.@L
@L
Obviously, placing the corners and the edge pieces first is a good strategy. The
top and bottom edges can usually be solved pretty easily because the letters run
across those tiles making words where they meet along the left and right edges of
the tiles. The left and right edges can be solved (if you want an easier puzzle) by simple trial and error of dragging the tiles up and
down until they glue together and lock to the corners (if Auto-lock is enabled).@L
@L
Once the edges are in place, then the next thing I usually do is scan for the
"middle" pieces.  Remember, there are two PAGES on each puzzle, and there's a
blank "vertical column" of space between the two pages. That means that the right-most
tiles for the left page will have empty space on their right side, and the left-most
tiles for the right page will have empty space on their left side, a 'margin.'  That
makes these tiles relatively easy to spot and get into the right column of the puzzle
at least, and (if you want and have Auto-lock enabled) they can be solved in the same
fashion as the left and right edges.@L
@L
Next, you'll notice that there are often tiles that don't have "complete lines" of text
on them. This happens at the end (or start) of a paragraph, and they can usually be
lined up with either the right-hand column of the left page or the right edge of the
puzzle, and any text on the pieces (if you are playing puzzles with more than one line
of text per tile) can be used to arrange the pieces in the proper order.@L
@L
Sometimes names or particularly unique words can be easily spotted and 'glued' together.
But eventually, you'll get to a point where you have to start at the left side of
a page and start "building words," sometimes guessing at what the word is and looking
for the tile that has the rest of the letters (and sometimes guessing wrong...)@L
@L
Finally, (and this is @Ithe@I most important thing to remember!) don't forget to blink!!!@L
@L
@P>
@C>***********************************************************************
@C>
@P 5 "Options" "(Playing \"just one more game\" is ALWAYS an option)">
There are many option settings that allow you to customize the way the program
behaves.  These are all accessed via the @IPlayer@I menu.  This section discusses
the @IPlayer-Options@I dialog. Other options are covered in these sections:@L
@T3>@H 6 0 "Keys, Toolbar, and Menu">@L
@T3>@H 7 0 "Mouse Button Mapping">@L
@T3>@H 8 0 "Graphics">@L
@T3>@H 9 0 "Music & Sounds">@L
@L
@U@BPlayer Options@B@U@L
@L
Each player has their own set of options, so each player can configure the
game the way they want without regard for how other players want it configured.
Additionally, each player can have TWO different configurations of the settings
in the @IPlayer-Options@I dialog: the currently active option settings, and
an @Ialternate@I configuration of option settings.  You can swap between these
within the @IPlayer-Options@I dialog by clicking the @ISwap alternate options@I
pushbutton.  Within the game (when no dialog is showing) you can swap the option
settings by pressing @B@S7-F@B.  If there are some options that you regularly
toggle back and forth, this allows you to do so with a simple @S7-F key press
(once you've set up both sets of options) rather than having to go into the
@IPlayer-Options@I dialog and toggle them manually every time.@L
@L
@GH 238 0 20 10 10>You can also use this button on the toolbar to toggle
between the alternate sets of @IPlayer-Options@I.  The image on the
button shows the CURRENT set of options that are operational.  Also, RIGHT-clicking
on this button will bring up the @IPlayer-Options@I dialog.@L
@L
@BBypass title screen:@B When checked, the title/copyright screen is not displayed
when the program is started.  This option is only available in the licensed version
of the game.@L
@BEnable game sound effects:@B Uncheck this to turn OFF most game sound effects.@L
@BEnable error sound effects:@B Uncheck this to turn OFF sound effects when you
make a logical error or when you click somewhere that makes no sense.@L
@BAuto-advance to next puzzle:@B If checked, the game will go from the win display to the next puzzle
instead of pausing at the puzzle that was just solved and only advancing after another click.@L
@BConfirm on restart puzzle:@B If checked, clicking on the Restart Puzzle button
causes a "Confirm: restart puzzle?" prompt to appear if the puzzle has been partially played.@L
@BShow pop-up tooltips for toolbar buttons:@B If you hold the mouse cursor still over a toolbar
button, a pop-up reminder will appear explaining what that button does.@L
@BShow timer and CLICK count on toolbar:@B If checked, the elapsed time for solving the current
puzzle is displayed on the toolbar along with the number of 'clicks' (tile movements and key presses
that affect the state of the puzzle) that have been used in solving the puzzle.  These values are also
written to the BBSCORES.CSV file in the data (modified files) folder, even if this option is turned off.@L
@BAuto-Jump to farthest bookmark:@B If checked, the program will automatically jump
to the farthest bookmark (the farthest point in the book that's been solved).  If not
checked, the program will tend to stay on the puzzle you've selected, whether it's solved or not.
This is useful if you've solved many puzzles, and then want to go back and read the
story all at once.@L
@BAuto-start corners if non-0 border width:@B If checked and the @IBorder width@I is set to something
other than zero (i.e., there IS a border shown on the border tiles), then the four corner tiles
will be automatically placed in their correct locations in the puzzle area.@L
@BAuto-start edges if non-0 border width:@B If checked and the @IBorder width@I is set to something
other than zero, then all of the edge tiles (the tiles that show the border) will be automatically
placed on the correct SIDES of the puzzle, although not usually in their correct locations.@L
@BAuto-lock tiles from corners:@B If checked, then when corner tiles are correctly placed, they will
become 'locked'. Locked tiles are immovable by the player and are drawn in a different color to signify this. Tiles
that are correctly placed and GLUED to those corner tiles will also become locked.@L
@BAuto-glue tiles horizontally:@B If checked, then the game will automatically @Iglue@I tiles
left-to-right that are correctly placed next to each other (not necessarily in the correct location,
just in the correct orientation left-to-right of each other). Tiles that are glued together will be
drawn with a different 'shading' color and, if in the work area, the gap between them will be filled
with a "gap color" (see how these colors are set and changed in @H 8 1 "Graphics COLORS">). Tiles
that are glued together will MOVE together when you drag them.@L
@BAuto-glue tiles vertically:@B If checked, then the game will automatically @Iglue@I tiles
up-and-down that are correctly placed next to each other.@L
@L
NOTE: Some folks will want to have @IAuto-glue@I enabled in both directions, whereas other folks
will feel that's too much 'cheating' and will only want @IAuto-glue tiles horizontally@I enabled
so that they still have to puzzle out which "lines of text" go in which order as they piece together
the text.  Others, of course, will want neither @IAuto-glue@I option enabled.  But that's why there
separate @IAuto-glue@I options for horizontal and vertical tile gluing.@L
@L
@BStart with all tiles in the puzzle area:@B If checked, then all tiles start in the PUZZLE area.
If not checked, all tiles start in the WORK area (unless corner and/or edge tiles are auto-placed).@L
@M 1>@BShow entire work area (no scrolling):@B If checked, the tiles are made small enough that the
entire puzzle and work areas can be seen within the game window.  If not checked, then the tiles
are made as large as possible so that the PUZZLE area is completely filled VERTICALLY. The PUZZLE and
WORK areas will then have scrollbars, if needed, in order to view the portions of those areas that
are not visible. This option can be toggled during normal game play by pressing the Z ("zoom") key
and/or by clicking the MIDDLE mouse button in either the PUZZLE or WORK area.@L
@L
NOTE: To understand the effect of the following two options, you need to understand how the tiles are
drawn. When drawing a tile, first the 'normal' SOLVED tile is drawn using the SOLVED or UNSOLVED
(as appropriate) background and text colors (or a painted image, as the case may be). Then, the
appropriate FACE color is semi-transparently painted over the top, giving the tile a different
hue (depending upon whether it's solved or unsolved, glued or not glued, locked or not locked).
Then, the EDGE color is semi-transparently drawn along the edges of the tile. Additionally, the
border tiles get any border lines drawn on them.  With the following options, you can control
the AMOUNT of semi-transparency of these elements.  The greater the transparency, the easier it
is to see the text and images on the tiles but the more difficult it is to tell apart the different
states of the tiles (glued, locked, etc). The lesser the transparency, the easier is is to spot
the different states of the tiles (glued, locked), but the more difficult it is to see the text
and images on the tiles. Everyone has different tastes (and eyes), so the optimum settings for
these options will be different for different people.  Imagine that. The actual colors used for
the EDGE and FACE overlays (and many other things) are specified in the @H 8 1 "Player-Colors dialog">.@L
@L
@BUnlocked tile edge transparency:@B Controls how transparent the EDGE lines are on the tile. The higher
this option's value the less pronounced the edge line will be but the easier it will be to see the
pixels of tile at the edge of the tile. The lower this setting the more opaque the edge line will be,
making it easier to WHERE the edge of the tiles are, but making it more difficult to see the pixels
that make up the text and/or image at the edges of the tiles.@L
@BUnlocked tile face transparency:@B Controls how transparent the FACE overlay is on the tile. The higher
this option's value the less pronounced the face overlay will be but the easier it will be to see the
actual contents of the tile.  The lower this setting the more opaque the face overlay will be, making
it easier to spot the different states of the tiles (glued, locked), but the more difficult it will
be to see the actual text/image contents of the tile.@L
@BWork area spacing:@B Controls how much "empty space" is between the tiles in the WORK area. This
is specified as a percentage of ONE TILE WIDTH. If set to 0, then there will be no gap between the
tiles, just like in the PUZZLE area. The spacing can be up to 40% (2/5 of the width of one tile).
When tiles in the WORK area become glued together, this spacing gap will be filled with the @IGlued tiles gap@I color
as specified in the @IPlayer-Colors@I dialog.@L
@BBorder width:@B Controls the width of the BORDER around the ...er... border of the puzzle. A value
of zero means there will be NO border and it will be up to you to figure out which tiles are corner
or edge tiles. A value of 99% means the border will be at its maximum thickness. Because this border
is opaque and overlays any text or graphics that would be drawn on the tile, for puzzle types where
the number of lines of text per tile is 2, 3, and 4, the top-most and bottom-most edge tiles have
one less line of text than all of the other tiles. This prevents the border from (potentially) hiding
all or part of a line of text.@L
@BAuto-save period:@B This game automatically saves your progress (hence, there's no "Save game" button
or menu entry). It does this automatically when you exit the game or change to a different puzzle or book.
But if your computer hangs or crashes, any progress you've made on the puzzle since the last save
would be lost.  This option causes the program to automatically do a "save game" of your progress
periodically. Setting this to 0 will turn off this periodic save feature (although the game WILL still
save your progress automatically when you exit the game or change puzzles or books!) Setting this
to any non-0 value will cause the game to save your progress every-that-many-seconds. A low value
here is not recommended, as it would cause the game to unnecessarily 'thrash' your storage. Too high
of a value increases the risk that you may lose significant progress in the event of a computer
hang or crash.  The default value is every 30 seconds.@L
@L
@P>
@C>***********************************************************************
@C>
@P 6 "Keys, Toolbar, and The Menus" "(The keys to the kingdom!)">
@U@BThe Keyboard@B@U@L
The keys that are available to you during game play are:@L
@L
@BF1@B brings up the Help (same as clicking on the @IHelp-How to play@I menu).@L
@B+@B and @B-@B move you to the next and previous puzzle numbers.@L
@BN@B goes to the puzzle at your bookmark (first unsolved puzzle).@L
@BP@B toggles (hides or shows) the PROGRESS BAR in the explanation box. This bar
gives a graphical indication of how far you are through the book.@L
@BZ@B toggles the @IShow entire work area@I option.@L
@B@S7-F@B swaps alternate options settings (see @H 5 0 "Player-Options">).@L
@B@S7-Z@B performs an undo (same as the button on the toolbar).@L
@BSHIFT-@S7-Z@B performs a redo (same as the button on the toolbar).@L
@B@S7-Y@B performs a redo (same as the button on the toolbar).@L
@B@S7-B@B moves the bookmark to specific puzzle number. Deletes any saved game, solves all puzzles before that one, and unsolves that puzzle and all puzzles after it.@L
@BARROW (cursor) keys@B If multiple tiles are selected (SHIFT-LEFT), then the the
arrow/cursor keys move those tiles one tile position at a time.@L
@BENTER@B does the same as the "up-left" compression button on the vertical bar dividing the PUZZLE area from the WORK area.
That is, the tiles in the WORK area will be compressed as much as possible up and to the left,
filling any empty tile positions.@L
@L
@L
@U@BThe Toolbar@B@U@L
At the left of the game screen is the toolbar/menu area.@L
@L
Most of the buttons on the toolbar should be reasonably
obvious, and a brief 'tip' is shown as you hold the mouse cursor still
over a button for a second.  The buttons are:@L
@L
@GH 238 50 20 40 10>The left column of buttons controls how many TILES there are in
your puzzles. 1 gives you 8x6 (48 total) tiles, 2 gives you 12x9 (108) tiles, 3 gives
you 15x12 (180) tiles, and 4 gives you 20x15 (300) tiles.  The right column controls
how many lines of text appear on each tile, from 1 to 4.  The two of these together
(and the size of your game window) will control the size of the text. This means there
are 16 different possible ways of presenting the book to you, with more or less text
in each puzzle and with that text broken up onto more or less tiles. You'll probably
find one or two of these combinations will suit you best and you'll tend to stick
with them. But you'll need to experiment in order to find the ones you like best.@L
@L
NOTE: Most of the combinations of number-of-tiles and lines-per-tile will result
in a book being broken up into different puzzles, as different amounts of text
will fit in a puzzle at different font sizes.  However a FEW of the combinations
actually result in EXACTLY the same "pages of text," just broken up into different
tiles. If we consider the puzzle types to be "TL" (where 'T' is the number-of-tiles
setting from 1 to 4, and 'L' is the lines-per-tile setting from 1 to 4), then puzzle
types 13 and 22 will break a book up into exactly the same "pages of text" (puzzles),
14 and 32 will be the same puzzles (just different numbers of tiles), and 24 and 33
will result in the same puzzles. This is a technical detail that most folks won't
care about and will never become aware of because they don't read the Help screens,
but I include here as a special bonus for you because you're obviously a Special Person
because you DO read the Help screens.@L
@L
@GH 238 0 20 10 10>Shows whether the 'regular' or 'alternate' sets of Options
are currently active, and swaps them when you click the button.  (Same
as pressing @S7-F or going into the @IPlayer-Options@I dialog and clicking on
the @ISwap alternate options@I button.)  Additionally, you can RIGHT-click on this button
to bring up the @IPlayer-Options@I dialog.@L
@M 1>@GH 228 65 10 10 5>Opens the @ISelect book@I dialog, which shows the list of available
books. You can double-click on a book in the listbox to open that book, or single-click to
select it, then click on OK.  Cancel, of course, ends the world, as if it never existed. To
find out how you can add additional books to the game, see @H 10 0 "All about books">.@L
@GU0>@GU2>Previous puzzle and next puzzle with the current puzzle number below them.  The
puzzle number has a RED background if the current puzzle has not been previously solved, or it
has a GREEN background if it has been solved.  You can left-click in the puzzle number edit
box, edit the puzzle number, then press the ENTER key to jump to a specific puzzle number.@L
@GU4>Restarts the current puzzle.@L
@GH 228 75 10 10 5>Restarts the entire book (all puzzles in all puzzle types!)@L
@GU8>@GU10>Undo and redo.  If you undo and make a move manually, redo is disabled.@L
@L
@U@BThe Menus@B@U@L
The main game menu items are self-obvious (if they weren't, I'd have to write about them here in
the Help, and I don't want to do that, hence I define them as inherently self-obvious.  Ah, the
joy of power!).  The menus are organized into three primary groups: Help (help, order form,
shareware copy, about), Game (general game-related items that are not player-specific), and
Player (for managing multiple players and changing player-specific options).  The
@IPlayer-Game graphics@I, @IPlayer-User interface graphics@I, @IPlayer-Music@I,
@IPlayer-Mouse button mapping@I, and @IPlayer-Options@I are covered by separate help
topics.  A few of the other dialogs are covered below.@L
@L
@BPlayer-Select player:@B You can have multiple player setups or configurations, and all of the
settings for each player are maintained separately in the @B@S5@S3@B file.  (Deleting
the @B@S5@S3@B file while the game is not running will cause all player settings to be lost, and cause
the program to start up as if it had never been run before.)  If there is only one player configured,
then the program automatically loads that player when it starts up.  However, if there is more than
one player configured, then the game will automatically display the @ISelect player@I dialog when it
starts, to let you select which player you want.@L
@L
@BPlayer-Language:@B This program supports the translation of almost all of the text strings used
by the program into other languages, including UTF-8 encoded characters.
Alternate language files may be distributed with the game, and as others become available they
will be placed on the @S1 page of the www.kaser.com web site for you to download.  If there
isn't a translation to YOUR favorite language, you can attempt one yourself: the Help is stored in
the @BHLP_English.TXT@B file, and all other program strings are stored in the @BSTR_English.TXT@B file,
both in the @B@S4LANGUAGE@B sub-folder.  These are UTF-8 encoded files (simple ASCII text files for the
English versions), which
can be loaded into most text editors.  Make a copy of one of the existing files to your language name,
and then edit it until your heart's content (or until your heart's sick, whichever comes first...)
Just be sure to SAVE the file as a TEXT file (using UTF-8 encoding if you use any characters other than
the lower 127 ASCII characters), not as some proprietary .DOC, etc, file format!!!
There are comments at the beginning of each file that describe the file format.
The file name for Help files has this format: @IHLP_xxxxxxx.TXT@I, where the @Ixxxxxxx@I portion is the
name of your language (and it is that portion of the file name that is displayed in the @IPlayer-Language@I
dialog).  The file name for the other strings file has this format: @ISTR_xxxxxxx.TXT@I, where the @Ixxxxxxx@I
portion is the name of your language.  If you make a translation of one or the other of these files,
please consider sending it to @Beverett@@kaser.com@B and it will be added to the web site for others
to download.  @BNOTE:@B these files are "checksummed".  When you modify them, that modifies the checksum,
which then won't match.  When the program starts, it checks the checksum of the "other strings" file and
if it doesn't match, it FORCES the displaying of the title/copyright screen with a warning message that
the program text has been modified.  Similarly, the Help file is also checked before the Help is opened,
and a warning displayed.  This is to prevent unauthorized modification of these files without the user
being aware of it.  If you want to make a translation, when you're done email it to Everett Kaser Software
(everett@@kaser.com) and we will checksum it before adding it to the web site (and emailing it back to you).@L
@L
@BPlayer-Select book:@B Opens the @ISelect book@I dialog in which you can select the book
you wish to solve and read. Same as the @ISelect book@I button on the toolbar (see @H 6 1 "above">).@L
@L
@BPlayer-Colors:@B Opens the @IColors@I dialog in which you can load different pre-made color sets
or edit the colors used in a color set.  See @H 8 1 "Graphics COLORS"> for more information.@L
@L
@BPlayer-Font:@B Opens the font style selection dialog in which you can set whether you prefer
@Iserif@I or @Isans-serif@I fonts to be used in the puzzles.  Changing this setting changes
the puzzles in the game, so PLEASE read @H 11 0 "Fonts"> BEFORE changing this setting.@L
@P>
@C>***********************************************************************
@C>
@P 7 "Mouse Button Mapping" "(But... but... I'm LEFT-handed!!!)">
The game supports up to 5 mouse buttons: left, middle, right, BACK, and FORWARD.  All of
these (and especially the latter two) require that your computer's mouse driver be configured to
do the 'default' action for those buttons in order for this mapping to work.  Many mouse drivers
will default to having the buttons (other than the left button) be mapped to weird things like
'double-left-click' or 'undo' etc.  To fix these problems you need to run Control Panel, and the
Mouse application, and set the buttons to reasonable defaults.  I can't give you much better
directions than that because the Mouse configuration application varies from manufacturer to
manufacturer.  But generally if one has an option that says "(default)" after it, that's the first
one to try.@L
@L
Once you have the mouse driver properly configured, then you can modify the game's button
functionality using the @IPlayer-Mouse button mapping@I dialog.  You can map functions to any
of the buttons and any combination of SHIFT and/or @S7 with the buttons.  The game will remember
and maintain these mappings separately for each player.@L
@L
To change the mappings, first select the button (or SHIFT-@S7-button combination) that you wish
to change, then select the action you wish that button to accomplish when it's clicked.  When
you select a different button, the "action" settings are automatically changed to show what is
currently mapped to that button.@L
@L
The available functions are:@L
@L
@BDrag tiles:@B Normally mapped to LEFT, point at a tile, hold DOWN the left mouse button, drag the tile to its new location, then release the left button.@L
@BClick to pick up, drag tiles, click to drop:@B For those who don't want to hold down the left button while moving tiles. Left-click (and release) on a tile, now move the mouse
(thus moving the tile) until the tile is at its new location, then left-click (and release) again to drop the tile.@L
@BToggle "Show entire work area":@B Normally mapped to MIDDLE, clicking this in the PUZZLE or WORK area toggles this @H 5 1 "Player-Options"> setting.@L
@BSend tile to the other window:@B Normally mapped to RIGHT, sends the clicked tile (and any tiles glued to it) to the other window (PUZZLE or WORK) as long as the tiles aren't LOCKED.@L
@BSend all tiles to the other window:@B Normally mapped to @S7-RIGHT, moves ALL tiles from the clicked on window (PUZZLE or WORK) to the other window.@L
@BSelect multiple tiles:@B Normally mapped to SHIFT-LEFT, drag to select a rectangular group of tiles. All tiles that are even PARTIALLY within the rectangle will be selected. Subsequent "Select multiple tiles" actions will ADD
those additional areas to the group of selected tiles, allowing you to select non-rectangular groups of tiles. Once selected, "Drag tiles" or "Click to pick, drag tiles, click to drop" can
be used to move that selected group of tiles.  Also, the arrow/cursor keys can be used to 'shift' the group left, right, up, and down one tile at a time. Note that the
multi-tile selection state is NOT saved on the UNDO stack nor when you exit the game.  It's VERY ephemeral!@L
@BCompact tiles in work area:@B Normally mapped to SHIFT-MIDDLE, click in either the PUZZLE or WORK area to cause the WORK area tiles to be 'compacted' up and to the left as much as possible, filling any empty tile locations.@L
@BUndo:@B Same as UNDO button on toolbar.@L
@BRedo:@B Same as REDO button on toolbar.@L
@BNo action:@B Doesn't do a darned thing.@L
@L
The dialog also includes these mouse-related options:@L
@GH 238 10 20 40 10>@BShow touch-screen mouse buttons:@B When using the game on a touch-screen display (not using a mouse), you can enable five
"virtual mouse button" selection buttons on the toolbar by turning ON this option.  Those five buttons represent the LEFT, MIDDLE, RIGHT, BACK, and FORWARD
mouse buttons.  With these buttons enabled, when you touch the screen with your finger, the function that
will be activated is the function that is mapped to the currently selected virtual mouse button. So, if you select the RIGHT
"mouse button" on the toolbar (the double-wide button with the right-button darkened), then tap on the puzzle, it will be
as if you had clicked the right mouse button, and whatever function is mapped to the RIGHT mouse button in this dialog will get executed.
If you touch and drag your finger, it will be as if you held down the right mouse button and dragged it.
If you then select the LEFT virtual mouse button on the toolbar, touching the display
will invoke the same functions as clicking the LEFT mouse button.@G>@L
@L
You can still map whatever functions you want onto the five supported mouse buttons.  Whichever button
you select on the toolbar simply maps your finger-touch to the functions mapped to that button.
@L
@BReverse mouse wheel movement:@B Different people think differently.  (Does this come as a huge shock
to you?)  Moving the mouse wheel forward or backward may seem... backward... to some folks.  This option lets you
change the meaning of the directions for the mouse wheel movement of the scrollbars in the PUZZLE and WORK areas.
Which way is 'right' for you depends upon whether you're thinking of moving the AREA or the SCROLLBAR, since they
move in opposite directions.@L
@L
@P>
@C>***********************************************************************
@C>
@P 8 "Graphics" "(So, you've always wanted to be Leonardo or Pablo?)">
@U@BUSER INTERFACE GRAPHICS@B@U@L
The user interface in @S1 is controlled by a .UI file, and three types of graphic
files, all stored in the @BCOMMONUI@B folder that is up one level from the game folder.
For example, if the game is installed in \EKS\@S0 then the UI files will be stored in
\EKS\COMMONUI.  The UI graphics files can be either "lossy" (.JPG) files or "lossless"
(.BMP) files.  The names all start with @BT_@B, @BB_@B, or @BP_@B.  The T_ files
contain background graphics for the Toolbar (hence the leading T_).  The B_ files
contain the images of the Buttons (hence the leading B_) on the toolbar.  The P_ files
contain the background graphics for the Puzzle area (hence the leading P_).
If you wish to add your own (or modified) graphics to the game, simply place
your files in the UI sub-folder, and they will then be accessible for selection
in the @IPlayer-User interface graphics@I sub-dialogs.@L
@L
The .UI files (in the UI sub-folder) are binary files (not editable in a text editor)
which contain the color settings for many aspects of the user interface, as well
as the names of the graphics files to be used.  Thus, each .UI file specifies the complete
user interface "style".  However, if you wish to share a UI style with someone else,
you must give them the .UI file AND any graphics files that it uses (unless the graphics
are ones that come with the game itself).@L
@L
NOTE: because the UI files are stored in the COMMONUI folder (which is shared by
some other games from Everett Kaser Software, making changes to this folder and/or
the files in it may have an effect upon other games.  For example if you're using
the same color scheme in @S1 and some other game, and you edit that color scheme
in @S1, you'll find that the same color changes will appear in the other game
the next time you run it.  Similarly, once you've added any files to the COMMONUI
folder, they immediately become available to any other games from Everett Kaser Software
that use this COMMONUI folder.  The plan is that all future games will use this folder!
(Of course, "the best laid plans of mice and men...")@L
@L
NOTE: I recommend NOT editing or changing any of the UI schemes that come with the
games, because if in the future you install (or re-install) any Everett Kaser
Software games, these COMMONUI schemes will very likely get written over.  If
you want to make changes to existing UI schemes, make a COPY of the scheme to
a new name, then edit that copy.  That way the modified copy won't get overwritten
by any future installs or re-installs.@L
@L
Several UI graphics schemes are included with the game.  If you'd like to create your
own, first select one from the list that you wish to use as a starting point, then
click on the @ICopy@I pushbutton.  You will be prompted for the new file name.  Once
you've entered the new name and created the duplicate UI file, then click on either
@IEasy edit@I or @IAdvanced@I.  There are many (MANY!) different colors used to draw
the various elements of the game, menus, dialogs, help, etc.  To set all of those
properly can be a confusing and daunting task.  The @IEasy edit@I dialog is designed
to let you set a half-dozen of the major colors, and then the program automatically
sets all of the other colors based upon those.  The @IAdvanced@I dialog gives you
complete control over each individual color (but you'd better know what you're doing!)
Using the @IEasy edit@I dialog to edit a UI file that was previously edited with the
@IAdvanced@I dialog may change a lot of color settings that had been manually set, so
you should stick to either the @IEasy edit@I method or the @IAdvanced@I method, and
don't keep going back and forth.  You can start with the @IEasy edit@I, and once the
UI is looking close to what you want, you can then use @IAdvanced@I to "fine tune" it.
But once you've done that, don't try using @IEasy edit@I again on that UI file, or you'll
lose all of your "fine tuning."@L
@L
@BNOTE:@B because it takes time to redraw the whole display, the display is not updated
in real time as you change the colors, etc.  Everything will get redrawn when you click
@BOK@B to close the dialog, or if you click @BApply@B to apply those color changes
without closing the dialog.@L
@L
Both @IEasy edit@I and @IAdvanced@I dialogs also let you select the graphics files to
be used, as well as 4 other options that control the UI:@L
@T3>@BNo toolbar back image (solid color):@B if checked, the @IToolbar background@I
graphics file is not used, and the toolbar background is drawn the solid color
specified by the @IToolbar/status background@I color setting.@L
@T3>@BStretch toolbar proportionally:@B if the above is NOT checked and this IS checked,
then the toolbar background graphics file is stretched such that the aspect ratio is maintained
(but it may not fill the entire toolbar area).  If this is NOT checked, then the toolbar
background image is stretched to fully cover the toolbar background vertically AND horizontally,
which may "deform" (like a fun-house mirror) the background image.@L
@T3>@BTransparent status background:@B If checked, then the time, hints, and notifies are drawn
on the toolbar so that the toolbar background image appears behind the text.  However,
some background images might make the text difficult to read, in which case you should
UNcheck this item.  Then, those status items get a solid color drawn behind them, specified
by the @IToolbar/status background@I color.@L
@T3>@BNo game background image:@B If checked, the @IGame background@I image is not used to
draw the background behind the puzzle, but rather it's drawn a solid color
which is specified by the @IPuzzle background (if no image)@I color.@L
@L
In the @IAdvanced@I dialog, there are so many colors to be set that they are grouped.
You first have to select the @IColor group@I (Menu, Dialogs, Help, Toolbar, or Misc), then
select the specific @IColor@I.  Frequently, there will be several items that you'll want
to set to the same color.  To do this, first set one of them to the desired color, then
(with that item still selected) click on the @ICopy@I pushbutton.  This will copy that
color into an internal "clipboard" buffer.  The color that's currently in the color clipboard
is shown in the small rectangle to the left of the @ICopy@I and @IPaste@I pushbuttons.  Then,
select another Color item that you wish to set to that same color, and then click the @IPaste@I
pushbutton.  Again, remember that these color changes will NOT be visible in the rest of the
game screen until you click @BOK@B or @BApply@B, they will only appear in the small "sample"
rectangles to the left of the color radio buttons.@L
@L
@M 1>@U@BCOLORS@B@U@L
Unlike most of my other games, there are no image sets you can load to change
the appearance of the game display. However, there is a @IPlayer-Colors@I dialog
which will let you change some of elements of the game display.  In this dialog,
you will see a list of color elements down the left side, a 'sample' display
at the bottom-center, a color selection tool at the upper-right, and a list
of currently available "color sets" at the bottom right, with a copy/paste
buffer at the far right.@L
@L
NOTE: It's recommended that, if you wish to experiment with changing colors,
the first thing you should do upon entering the dialog is to click on the
@ISave as...@I button and save the current color set to a new file name.
The new color file will be saved in the @BCOLORS@B sub-folder of the @B@S5@B folder.
Once you've done that, you'll still be able to go back to the original color
settings by reloading the EKS_BeckettsBooks color set (or one of the other
pre-made sets).@L
@L
To make changes to your color set, select the desired element from the list
on the left, then make changes to the color using the HUE, SATURATION, and
LIGHTNESS controls at the top-right (or by clicking within the color gradient
window or dragging the small circle 'cursor' therein, to change both the
LIGHTNESS and/or SATURATION at the same time).  As you change the color, the
change will automatically be reflected in the 'sample' drawn at the bottom-center.@L
@L
The puzzle tiles may contain images or text.  If text, then the tile is first
filled with the BACK color, then the text is drawn with the TEXT color (unsolved
or solved, depending upon the state of the puzzle).  Then, depending upon the
state of the tile, if it's glued or locked to another tile, a FACE HIGHLIGHT color
will be drawn over the top of the tile (in a semi-transparent fashion), so the
BACK and TEXT colors get modified.  This will have a much more consistent affect
upon tiles containing text, whereas on tiles with images (which MAY also contain
text within the image, but that text is still an IMAGE), the effect of this
FACE HIGHLIGHT will be much less consistent when the image contains many different
colors.  After the FACE HIGHLIGHT is drawn, then an EDGE HIGHLIGHT is drawn around
the edge of the tile (except for the edges where tiles are glued or locked to other
tiles).@L
@L
Some other colors that can be modified are:@L
@T5>Explanation box.@L
@T5>The puzzle and work area background and grid lines.@L
@T5>The face highlight for tiles that are part of a multi-selected set of tiles.@L
@T5>The 'flash' that occurs when tiles are glued or locked together.@L
@T5>The 'gap' between tiles in the work area that are glued together.@L
@T5>The mark in the center of tiles that have no text or image on them (empty).@L
@T5>The 'Continue' and 'The end' messages on completed puzzles.@L
@L
This dialog can also be used to simply select a different pre-made color set
without actually doing any color editing.  Just open the dialog, select the desired
color set from the list in the bottom-right, then click the @IClose@I button.@L
@L
@P>
@C>***********************************************************************
@C>
@P 9 "Music & Sounds" "(Or should that be \"The Sounds of Music\"???)">
The @BMUSIC@B files are MIDI files, and if you have MIDI files of music that you would prefer to the
ones provided (or in addition to), they can be added to the game.  Just copy your MIDI files into
the MUSIC folder, and then add them to your playlists in the @IPlayer-Music@I dialog.  The MUSIC
folder is located one level "up" from the @B@S0@B folder.  If, for example, the game is installed
in \EKS\@S0 then the MIDI files will be stored in \EKS\MUSIC.  To add MIDI files to your
playlist, the files MUST be in the MUSIC folder.  Then, in the @IPlayer-Music@I dialog, select the
music file in the @IAvailable MIDI files@I list box and click on the appropriate "Add >>>"
pushbutton.  MIDI files can be removed from a playlist by selecting the file in the playlist, and
then clicking on the appropriate "<<< Remove" button.  By default, all of the MIDI files in a
playlist are played in sequence.  If you'd prefer to hear them in a random order, just check the
@IPlay music in random order@I checkbox.  Some folks (like me) get tired of listening to MIDI files
while they play the game, so there are options to disable (turn off) background and win music.@L
@L
A number of @BSOUND EFFECTS@B are played at various times during the operation of the game.
These can be disabled by unchecking the @IEnable game sound effects@I and/or @IEnable error sound
effects@I checkboxes in the @IPlayer-Options@I dialog.  The sounds are stored in standard WAVE
files, so you can modify the sounds used by the game if you want to.  To do this, I recommend
copying the current WAVE files to a backup folder in case you ever want to recover them, then
copy the WAVE file of your choice to the filename which the program uses.  The game stores all
of its WAVE files in the @B@S0@B folder (the same folder as the program).@L
@L
These are the WAVE filenames and when they're played:@L
@T3>COOL - when you solve a puzzle@L
@T3>FROZEN - when tiles in the WORK area are compacted@L
@T3>ILLCLICK - when you click on something that has no meaning or other minor errors@L
@T3>LOCK - when tiles are glued together@L
@T3>REDO - when you redo a move@L
@T3>UNDO - used when you undo a move@L
@T3>UNHHH - used when the idiot program can't figure out how to move tiles@L
@P>
@C>***********************************************************************
@C>
@P 10 "All about books" "(Is there a librarian in the house?)">
@B@UBOOKS, BOOKS, BOOKS@U@B@L
The books included with the game are kept in the PUZZLES sub-folder of the game folder:@L
@B@S4@B@L
If you want to add books to the game, you should make a PUZZLES sub-folder in the data folder:@L
@B@S5@B@L
and add them there.@L
@L
The text for a book is stored in a single .TXT file. If a book includes images, they
must also be stored in the PUZZLES sub-folder and must be .JPG files. Commands in the
.TXT file will reference these .JPG file names at the point in the book where the image
should be displayed. Sorry, no other image format is supported other than .JPG, and no
other text formats (HTML, DOC, etc) is supported. The text file may be plain US ASCII
or, better yet, UTF-8 encoded Unicode characters.  ONLY UTF-8 encoding is supported,
with or without a BOM (Byte-Order-Mark) at the start of the file. To create a UTF-8
text file, you'll need to use a text editor capable of saving in that format.@L
@L
It's possible for a book to be nothing but a series of images (in which case the "lines per tile"
buttons on the toolbar will have no effect), but you still need a .TXT file for it which
will list the image names in the order they should appear.  See the "OldNurseryStories" book
on the kaser.com web site for such an example.@L
@L
The .TXT file will get reformatted by the game as necessary.  End-of-line characters are
ignored EXCEPT when there are two End-of-line sequences in a row, which is considered to
be a "paragraph break."  Load into a text editor any of the .TXT files included with the
game and compare that source text with how the book appears in the game, and you'll quickly
see the pattern of how this "paragraph formatting" works.@L
@L
One excellent source for public domain books is Project Gutenberg (@BPG@B):@L
@T5>@Bwww.gutenberg.org@B@L
Most of the books included there are pre-1923, but some later works that have fallen out
of copyright are also included there. Often, you can find cover art by doing a web search
for the title of the book (in quotes) and IMAGES.  Then a little careful sifting and you
can usually find the original, or at least pre-1923, cover art and
sometimes interior illustrations.  To be sure you have original publication art,
frequently Wikipedia will show you the original art and/or artist. You then have to get the highest
resolution of those you can, then save them, resize them, etc.  Then
add them to the file.  Not trivial, but usually not TOO difficult.@L
@L
NOTE: @BPG@B is based in the United States of America, and thus
operates under the American copyright regulations.  Other countries
may have significantly different copyright regulations, and as such
other materials from before 1923 may still be under copyright. If
you want to add more books, it is your responsibility to ensure the
right rules are being followed. If you want to send any books to me
to be shared on the @S1 web page, I will only do so if I can verify
that they are public domain works under the laws of the U.S.A. (since
that's where the www.kaser.com website is hosted).@L
@L
In general, .TXT files downloaded from @BPG@B can be used almost
unchanged in the game.  Things you might want to do first are:@L
@T3>Strip the beginning and end of the file that talks about @BPG@B.@L
@T3>Clean up the title, author, table of contents to look better in the game.@L
@T3>Find the chapter headings (if any) and 'format' them (see game-included books for examples).@L
@T3>Find, download, format, and add any images.@L
@T3>Check for underscore characters. @BPG@B uses underscores to surround @Iitalicized@I text,
and after careful checking, you can usually do a global search and replace of an '_' character with '@@I' (minus the single quotes!)
to get actual italicized text in the game.@L
@L
You can name any image files whatever you want (as long as they're .JPG files, remember!), but
I recommend following this 'standard': if the book's .TXT file is called BookName.txt, then name
the image files BookNameXXX.jpg, where 'XXX' is 001, 002, 003, 004, etc. In this way, all of
the files related to the book will be listed together in a directory listing, and are easily
ZIP'd, deleted, or otherwise managed.@L
@L
Books with non-US-ASCII characters CAN be used with the game.  They need to be saved in a UTF-8-encoded .txt file,
but they WILL work.  However, the filenames still need to be in US-ASCII characters, as
the program doesn't know how to deal with non-ASCII file names (maybe some day).@L
@L
@L
@B@UFORMATTING THE BOOKS@U@B@L
There is no editor built into the game as there are lots and lots of perfectly
fine text editors already available.  You can use pretty much any text editor
to edit books for the game, but if you want to make them UTF-8 encoded, you'll
need to make sure your editor can handle that.@L
@L
There are a number of "formatting commands" that can be inserted into the book .txt files.  All
commands start with an '@@' character. Most commands start and end with the same @@-command, while
others use a single @@-command to accomplish some feature. If an actual '@@' character is needed
in the text of the book (or in the @@T, @@W, or @@D command texts), that can be accomplished
by using a double-@@ ("@@@@").  The commands that start AND end with
the same @@-command are:@L
@L
@B@@T@B - specifies the TITLE of the book to be shown in the explanation box.@L
@T5>Example: @@TSherlock Holmes #1: A Study In Scarlet@@T@L
@B@@W@B - specifies the WRITER of the book to be shown in the explanation box.@L
@T5>Example: @@WA. Conan Doyle@@W@L
@B@@D@B - specifies the DIVISION (part/chapter/etc) to be shown in the explanation box.@L
@T5>Example: @@DPart I Chapter I: Mr. Sherlock Holmes@@D@L
@L
@B@@V@B - insert a .jpg image into the puzzle.@L
@T5>Example: @@V1 Sherlock01AStudyInScarlet01.jpg@@V@L
@T5>Example: @@V0 Sherlock01AStudyInScarlet02.jpg@@V@L
The beginning @@V is IMMEDIATELY (next character) followed by a '0' (zero) or '1' (one), followed by
a single space that is ignored, followed by the filename of the .jpg file (including the .jpg suffix).
A '1' indicates the image is to fill an entire PAGE of the puzzle (left half or right half
of the puzzle). A '0' indicates the image is to fill a HALF PAGE of the puzzle (the top OR bottom
of the LEFT or RIGHT half of the puzzle). NOTE: the image is not guaranteed to appear EXACTLY
where you place it in the .txt file. Because of the fluidity of the text over different
puzzle types/sizes, the pictures will tend to "slide around" in the text, appearing at the
next POSSIBLE location after the point at which it is specified in the text, and that point
will likely be different at different puzzle types/sizes.  This is a game, not a word processor. Live with it.@L
@L
NOTE: Center, Right, and Hanging Indent justifications are mutually exclusive.
Invoking any of them will automatically turn off any previous ones, so they
can NOT be 'nested'. To return to 'normal' LEFT-justification, just use the
last (most recent) tag again to toggle it off.@L
@T5>Example: @@CI'm centered.@@RI'm right.@@HI'm hanging.@@L@@HI'm normal@L
@L
@B@@C@B - the included lines of text will be center justified on their page.@L
@T5>Example: @@CThis text is centered on the page@@C@L
NOTE: The @@C does not need to be at the start of the line.  Any text on the same
"formatted line" in the puzzle will be centered on the page, even if it comes BEFORE
the @@C in the .txt file. But it's good practice, to ensure you always get the
results you want, to place the @@C immediately after an @@L or after back-to-back
end-of-line sequences, so that you KNOW the @@C will be at the start of the line
that you wish to have centered.  It's also good practice to follow the terminating
@@C with an @@L or a double end-of-line sequence.  Also, the @@C pairs do NOT have
to be on the same line.  One @@C pair can span multiple lines, each broken with
an @@L or a double end-of-line sequence, and all included lines will be centered.
Regardless, after the terminating @@C, line justification returns to LEFT justified.@L
@L
@B@@R@B - the included lines of text will be RIGHT justified on their page.@L
@T5>Example: @@RThis text is right justified on the page@@R@L
See the NOTE for @@C above, it all applies to @@R as well.@L
@l
@b@@H@B - the included lines of text will be LEFT justified with a HANGING indent,
meaning the FIRST line of a paragraph will be at the left margin, and all of the
remaining lines of the paragraph will be indented.@L
@L
NOTE: @@B, @@I, or @@U style changes CAN occur in the middle of normal, left-justified
lines of text, but they can NOT occur in the middle of @@C center-justified or @@R right-justified lines
of text.  @@C and @@R text must have constant style, and @@B, @@I, or @@U commands should be done
outside of the @@C or @@R pairs. Repeat after me: this is a game, not a text editor. Live with it.@L
@L
@B@@B@B - the included text is drawn in a @Bbold@B font.@L
@T5>Example: This is a @@Bbold@@B word.@L
@B@@I@B - the included text is drawn in an @Iitalics@I font.@L
@T5>Example: This is an @@Iitalicized@@I word.@L
@B@@U@B - the included text is drawn @Uunderlined@U.@L
@T5>Example: This is an @@Uunderlined@@U word.@L
@L
@B@@F@B - the included text is drawn in a FIXED-pitch (typewriter) font instead of
the default VARIABLE-pitch font.@L
@T5>Example: The message looked like it had been @@Ftyped@@F on a typewriter.@L
@L
The "single @@" commands, which "stand alone" and do not have to occur in pairs, are:@L
@L
@B@@L@B - causes a "paragraph break." Text output moves to the next line, indented as at the beginning of a paragraph.@L
@T5>Example: This is the last sentence of a paragraph.@@L@L
@B@@M@B - causes a "line break." Text output moves to the next line, but is NOT indented as at the beginning of a paragraph.@L
NOTE: The only differences between @@L and @@M is whether the next line starts at the left margin or is indented.@L
@B@@P@B - causes a "page break," such as at the end of a chapter. I generally don't
like to use this, as I don't like a lot of "white space" to appear in puzzles, but
it's there if you want it.@L
@T5>Example: This is the last sentence of a chapter.@@P@L
@T7>@@CChapter 3136@@L@L
@T7>@@BTHE MIDDLE OF A VERY LONG NOVEL@@B@@C@@L@L
@L
@L
That's about it.  If you create some formatted books that you'd like to share, send me a copy of them (along with any images)
to me by email and I'll add them to the @S1 web page for others to enjoy.@L
@L
@P>
@C>***********************************************************************
@C>
@P 11 "Fonts" "(I want it MY way!)">
Before changing the @IPlayer-Fonts@I setting, PLEASE read the following!@L
@L
You don't have much control over the fonts used in this game.  The size of
the fonts are controlled by the size of the game window, the number of tiles,
and the number of lines of text per tile. The text files for the books can
specify whether a block of text is fixed-pitch (like a typewriter, where
every character has the exact same width) or variable-pitch (like most modern
computer displays and printed documents, where each character is only as wide
as necessary).@L
@L
However, you CAN control whether the font FAMILY used is SERIF or SANS-SERIF.
The game defaults to using SERIF fonts (which are fancier looking and have
lots of little fillips and prongs and other non-technical things on the characters
to make them look more ornate).  But many people prefer to read SANS-SERIF (non-Serif,
for those of you who don't understand French) fonts. But there's (as always) a 'gotcha.'@L
@L
@BChanging the @IPlayer-Fonts@I setting will force the game to completely regenerate
all of the puzzles and restart any puzzles you currently have in progress, @Ifor ALL books
and for ALL players!@I@B The reason is that two different fonts will draw the text at
slightly different widths.  Serif fonts tend to take up a little more room, with their fanciness,
than sans-serif fonts. Because of that, the book text files will get broken into different
puzzles depending upon the font that is used. The game saves information about how the book
gets broken up into puzzles, because creating the puzzles from the text file takes a little
bit of time, and recreating a LOT of puzzles can take a LOT of time. When you change the font,
ALL of that has to get thrown away and recreated. All players share the same information about
how the books get broken up in puzzles, so this font setting is GLOBAL as all players share it.
When you change it, it gets changed for ALL players.@L
@L
@BThe regeneration of the puzzles, after changing the font setting, can take anywhere from
many seconds to MANY MINUTES, depending upon how far you are into the book!@B So, when you
change from SERIF to SANS-SERIF (or vice versa), be prepared to wait a while, maybe even go
get something to eat or watch a movie or (to be truly wild) talk to your family. The reformat
will finish eventually, but the game may appear unresponsive for quite a while.@L
@L
Changing the @IPlayer-Fonts@I setting is not expected to be a common occurrence. You may
change it a few times until you determine which you prefer to use, and then just leave
it alone. At least, that's the recommendation of 9 out of 10 doctors and dentists.@L
@L
@P>
@C>***********************************************************************
@C>
@P 12 "Running the game on non-Microsoft OSs" "(Free at last!)">
This game has been completely written in a proprietary interpreted language
which makes very few assumptions about the operating system on which it's
running.  The first implementation of the @Iinterpreter program@I (the actual
program that is running on your computer, and which then @Iinterprets@I the
make-believe instructions of the proprietary language) was for Microsoft Windows
OS (like Windows 95, 98, Me, 2000, NT, XP, Vista, 7, 8, 10, etc, etc,
et-gagme-cetera), and has now also been implemented for Mac OS X 10.10 or greater.@L
@L
The source code for the interpreter (not the game, just the interpreter program),
while copyrighted, is freely available for personal use.  It can be acquired on
my website at www.kaser.com/kint.html and also is included on each CD copy of the game.
Documentation is included.  So, if you're a knowledgeable programmer with the
ability to compile programs on another platform, you're welcome to try porting
the interpreter.  Once the interpreter is @Iproperly@I ported, then the game should
run exactly as it does on Microsoft Windows.  If you try doing a port and encounter
problems, feel free to write to me and I'll do my best to help out, although my time
is limited so don't expect extensive support on your efforts.@L
@L
All of my games are written in this same interpreted language, so that the same
interpreter program can be used to run all games written in that language on all
platforms to which the interpreter has been ported.@L
@L
This game requires at least the 4.9 version of KINT.  The source codes for the
various versions of the KINT interpreters are available on www.kaser.com/kint.html.
I may do a Linux port someday, but for now the Windows versions of my games run
fine on Linux under WINE (search the internet).
@P>
@C>***********************************************************************
@C>
@P 13 "Technical Information" "(Where're my files???)">
All of the installed files for @S1 can be found in this folder:@L
@T5>@B@S4@B@L
NO files are installed in any of your operating system folders.  The only
files that may be installed anywhere else are MUSIC and/or UI files that
are stored in folders "one level up."@L
@L
Any files that get modified or added when the program is run are in this folder:@L
@T5>@B@S5@B@L
If you delete the added/modified files from that folder (while the game is not running),
then the next time you run the game, it will be as if the game was JUST installed.
BEWARE, though, that this will cause all statistics, player settings, added files, etc,
to be lost!@L
@L
In case you didn't know, you're running the game on this operating system:@L
@T5>@S6@L
@P>
@C>***********************************************************************
@C>
@P 14 "Credits" "(Who's to blame for this screw-up???)">
@S1 is a brand new game, completely of my own devising.@L
@L
Credits for translated strings and help files are shown in the @IPlayer-Language@I
dialog (as you select each language file in the lists).@L
@L
Many of the User Interface schemes accessed via the @IPlayer-User interface graphics@I
dialog were created by Kris Pixton.  Thanks, Kris!!!@L
@L
Finally, I would like to give a very large and very public "Thank you!"
to all of the folks who helped test the game and gave me comments and
suggestions during its development.  The game is better because of you!
(Of course, any bugs that remain in the program are your fault, too! :-)
@P>
